<h1>GetUrl</h1>

<p>GetUrl is used to display a web page or load a movie clip into the Flash 
Player.</p>

<table>

<tr>
<th nowrap>Field Name</th>
<th>Type</th>
<th>Description</th>
</tr>

<tr>
<td nowrap valign="top"><a name="ActionType">Type</a></td>
<td nowrap valign="top">unsigned int</td>
<td nowrap valign="top" align="right">8</td>
<td>Identifies the action when it is encoded.</td>
</tr>

<tr>
<td nowrap valign="top"><a name="ActionLength">Length</a></td>
<td nowrap valign="top">unsigned int</td>
<td nowrap valign="top" align="right">16</td>
<td>The number of bytes in the rest of the encoded action. The total number of
bytes in the encoded action is Length+3.</td>
</tr>

<tr>
<td nowrap valign="top">url</td>
<td nowrap valign="top">String</td>
<td nowrap valign="top" align="right">&nbsp;</td>
<td>The fully qualified uniform resource location where the movie clip or web 
page will be retrieved from.</td>
</tr>

<tr>
<td nowrap valign="top">target</td>
<td nowrap valign="top">String</td>
<td nowrap valign="top" align="right">&nbsp;</td>
<td>A level in the Flash Player where the movie clip will be loaded or frame or 
window in the browser where the web page will be displayed.</td>
</tr>

</table>

<p>To display a web page or new Flash movie the target can either be the name 
of the web browser frame or one of the following reserved words:</p>

<table>

<tr>
<td><code>"name"</code></td>
<td>opens the new page in the frame with the name defined in an HTML &lt;frame&gt; tag.</td>
</tr>

<tr>
<td><code>_blank</code></td>
<td>opens the new page in a new window.</td>
</tr>

<tr>
<td><code>_self</code></td>
<td>opens the new page in the current window.</td>
</tr>

<tr>
<td><code>_top</code></td>
<td>opens the new page in the top level frame of the current window.</td>
</tr>

<tr>
<td><code>_parent</code></td>
<td>opens the new page in the parent frame of the frame where the Flash Player id displayed.</td>
</tr>

<tr>
<td><code>""</code></td>
<td>(blank string) opens the new page in the current frame or window.</td>
</tr>

</table>

<p>To load a movie clip into the currently playing movie then the target is a 
string literal of the form "_level<i>n</i>". The Flash Player supports the 
concept of virtual layers (analogous to the layers in the Display List). Higher 
levels are displayed in front of lower levels. The background of each level is 
transparent allowing movie clips on lower levels to be visible in areas not 
filled by the movie clip on a given level. The main movie is loaded into 
_level0. Movie clips are loaded into any level above this (1, 2, 124, etc.). If 
a movie clip is loaded into a level that already contains a movie clip then the 
existing clip is replaced by the new one.</p>


<h2>History</h2>

<p>The GetUrl action is described as the ActionGetUrl action of the Macromedia 
Flash (SWF) File Format Specification. It was introduced in Flash 1.</p>
